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FOREWORD 


This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-04 64 ,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corpora^"  ion 
was  Mr.  Jimmy  P.  Maxwell. 


The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUB.CQNTRACT.QE 


ROLE 


Control  Data  Corporation 


D.  7\ppleton  Company 


ONTEK 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizona  State  University 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Responsible  for  Communication 
development . 

Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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SECTION  1 
INTRODUCTION 


DM  (Documentation  Management)  is  a  system  for  controlling 
changes  made  to  IISS  documentation.  The  IISS  documents  are 
stored  in  a  protected  environment  controlled  by  this  DM 
software.  All  changes  to  documentation  and  the  overview  files 
which  describe  where  documents  reside  are  made  by  using  the  DM 
functions  in  con;j unction  with  WPS-Plus  word  processing  software. 
The  word-processing  is  used  for  the  actual  viewing  and  editing 
of  documents. 

A  description  of  each  DM  function  is  given  first  and  tnen 
complete  examples  are  given  later.  No  knowledge  of  WPS-Plus  is 
needed  to  view  documents  but  is  required  to  edit  documents.  A 
rudimentary  knowledge  of  WPS-Plus  is  recommended  to  avoid 
confusion.  A  user  must  be  authorized  as  both  a  WPS-Plus  user 
and  a  DM  user  for  the  system  to  work. 

1 . 1  DM  Filing  S/stem 

The  Documentation  Management  system  files  documents  away 
under  five  subsystems,  which  will  be  asked  for  whenever 
referring  to  a  file: 

1)  SYS  (documents  which  have  system-wide  relevancy) 

2)  CDM  (documents  about  the  Common  Data  Model 

Processor  subsystem) 

3)  NTM  (documents  about  the  Network  Transaction  Manager) 

4)  COMM  (documents  about  the  Communications  subsystem) 

5)  UI  (documents  about  the  User  Interface) 

The  two-to-four  letter  designator  is  the  correct  response  to 
these  questions. 


1 . 2  Overview  Document 

Every  subsystem  will  contain  a  document  entitled 
"OVERVIEW.DOC".  It  will  contain  directory  and  content 
information  about  each  and  every  document  filed  away  under  that 
particular  subsystem.  To  print  or  view  it,  follow  example  #1, 
subsection  3.2,  page  3-3;  to  alter  it,  CHECK  OUT  and  RETURN  it 
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SECTION  2 
HOW  TO  USE  THE  DM 


The  DM  user  functions  are  displayed  in  a  menu  format  once 
the  user  has  successfully  entered  the  DM  program.  To  invoke  DM, 
simply  type  DM  at  the  VMS  prompt,  as  shown: 

$  DM 


Your  authority  for  being  in  DM  is  then  checked  and  the  menu 
is  displayed.  Please  remember  that  at  any  time  during  the  use 
of  the  DM  program,  you  may  enter  a  question-mark  in  response  to 
any  question  and  HELP  will  appear  to  guide  and  assist  you. 
However,  you  may  have  to  start  your  sequence  of  answers  again. 

The  main  menu  looks  like  this: 

DOCUMENTATION  MANAGEMENT 


1)  DIRECTORY  of  documents 

2)  RETRIEVE  a  document  for  viewing  only 

3)  CHECK  OUT  a  document  for  possible  editing 

4)  RETURN  a  checked  out  document 

5)  Enter  a  NEW  DOCUMENT  for  the  first  time 

6)  View  a  list  of  WHAT  YOU  have  Checked  Out 

7)  See  WHO  HAS  a  particular  Document  Checked  Out 

0)  EXIT  (a  <RETURN>  also  exits) 

?)  You  may  enter  a  '?'  at  any  time  for  HELP 

What  would  you  like  to  do  [0-7]  : 
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SECTION  3 


OVERVIEW  OF  USER  FUNCTIONS 


All  user  functions  except  CHECKOUT (#3)  and  RETURN (#4)  are 
available  for  use  by  anybody  who  is  authorized  to  enter  DM. 
Checkout  and  Returns  can  only  be  done  by  users  authorized  to  do 
so  within  a  particular  subsystem  or  set  of  subsystems. 


3 . 1  The  User  Functions 

1.  DIRECTORY  of  documents: 

This  will  display  the  contents  of  the  documentation  directory 
for  a  particular  subsystem.  Use  this  to  determine  the  exact 
name  of  the  document  you  are  looking  for  and  to  see  the  date 
when  it  was  last  returned  into  DM.  [Note:  If  you  do  not  know 
which  document  you  are  looking  for  at  all,  view  the  OVERVIEW 
document  using  the  RETRIEVE  function  and  WPS-Plus  (see  example 
#1)  in  subsection  3.2.] 

2.  RETRIEVE  a  document: 

Use  RETRIEVE  to  move  a  copy  of  the  current  document  to  your 
directory  so  that,  through  WPS-Plus,  you  can  view  or  print  out 
the  document.  (See  example  #1.) 

3.  CHECK  OUT  a  document: 

Use  CHECKOUT  to  move  a  copy  of  the  current  document  to  your 
directory  for  the  purpose  of  making  permanent  changes  to  it  with 
the  WPS-Plus  editor.  Once  you  have  checked  out  a  document  to 
edit  it,  no  one  else  can  check  it  out  until  you  RETURN  it. 

(See  example  #2  in  subsection  3.2.) 

4.  RETURN  a  checked  out  document: 

Use  RETURN  to  return  the  edited  version  of  your  checked  out 
document  to  DM.  Your  new  document  will  replace  the  previous 
version  of  the  document  and  will  clear  its  "checked  out"  status 
so  that  others  could  then  check  it  out. 

(See  example  #2.) 

5.  Enter  a  NEW  DOCUMENT: 

Use  NEW  DOCUMENT  to  add  a  document  to  the  IISS  DM  database. 

Your  new  document  must  have  a  unique  name  and  should  be 
mentioned  in  the  OVERVIEW  document  for  that  subsystem. 

(See  Example  #2.) 

6.  View  a  list  of  what  you  have  Checked  Out. 

7.  See  WHO  HAS  a  particular  document  Checked  Out. 
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Note:  To  DELETE  a  document,  notify  the  DM  administrator  as  there 
are  no  user  procedures  for  this  function. 

3 . 2  Examples  of  How  to  Use  the  Documentation  Management 
Facility 

The  document  we  are  using  in  our  example  is  called  DOCMAN 
and  belongs  under  the  "SYS"  subsystem. 

EXAMPLE  #1:  TO  VIEW  A  DOCUMENT  AND/OR  PRINT  A  DOCUMENT; 

If  you  have  no  idea  where  to  look  for  a  particular  document, 
this  procedure  should  be  followed  for  the  "OVERVIEW. DOC" 
document  which  sits  under  the  "SYS"  subsystem.  If  the  subsystem 
is  known  but  not  the  document,  the  "OVERVIEW.DOC"  document  under 
the  particular  subsystem  should  be  reviewed.  If  the  name  of  the 
document  is  known,  then  follow  these  procedures  using  that 
document's  name  and  subsystem. 

$  DM  (Enter  "DM"  at  the  prompt  to  start  Documentation 
Management  Facility) 

(Your  authority  to  be  in  DM  is  checked  at  this  point) 

DOCUMENTATION  MANAGEMENT 


1)  DIRECTORY  of  documents 

2)  RETRIEVE  a  document  for  viewing  only 

3)  CHECK  OUT  a  document  for  possible  editing 

4)  RETURN  a  checked  out  document 

5)  Enter  a  NEW  DOCUMENT  for  the  first  time 

6)  View  list  of  what  you  have  CHECKED  OUT 

7)  See  WHO  HAS  particular  documents  CHECKED  OUT 

0)  EXIT  (a  <RETURN>  also  exits) 

?)  You  may  enter  a  '?'  at  any  time  for  HELP 

What  would  you  like  to  do  [0-7]  :  2 

RETRIEVE  A  DOCUMENT 


If  you  are  unsure  of  the  document's  name  or  sub-system,  use  main 

menu  selection  1. 

Enter  the  Sub-System  :  SYS  (We  wish  to  retrieve  a  document  about 

the  SYS) 

There  are  two  types  of  documents  which  are  stored  under  DM: 

1.  Files  with  a  .DOC  file  extension  in  its  filename  are  stored 
in  standard  ASCII  format  and  can  be  read  or  typed  directly 
from  your  directory  once  retrieved  from  DM. 

3.  Files  with  a  .WPL  file  extension  in  its  filename  are  stored 
in  WPS-Plus  internal  format  and,  once  retrieved,  must  be 
read  into  your  WPS-Plus  index  so  that  you  can  edit  and 
hence  read  the  file. 
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Enter  the  Document  Name  :  DOCMAN.WPL  (a  WfS-Plus  format  file) 
Document  was  Found. 

I  am  now  copying  the  file  into  the  sub-directory  you  are  now  in. 
ALL  DONE. 

(DM  menu  is  printed  out  again.) 

What  would  you  like  to  do  [0-7]  :  (Press  Return  or  a  "0"  to 

exit. ) 

Exit 

30-September-1988  12:15:45 

To  check  to  see  if  the  document  is  in  the  VMS  directory,  enter 
the  following  command: 

$  DIR  DOCMAN.* 

Directory  IISS_CDC: [RABB] 

DOCMAN.WPL; 1 

1  File  Found. 

$ 

(The  document  has  been  placed  into  your  VMS  directory.) 

$  WPS  (Enter  "WPS"  to  bring  up  WPS-Plus  by  typing  WPS  at  the 
$  prompt  and  pressing  Return) 

At  this  point,  the  menu  for  WPS-Plus  will  come  up.  To  bring  your 
file  into  your  word-processing  folder,  enter  DT,  press  Return, 
and  the  Document  Transfer  Menu  appears;  enter  RV  (read  from  VMS) 
plus  Return.  Enter  the  name  of  your  file  (including  directory 
heading  v;hich  is  the  first  four  letters  of  your  account  name) 
Note:  Keypad  "0"  is  the  EXIT  SCREEN  key. 


Filename:  [RABB] DOCMAN. WPL 

A  "Creating  from  VMS  File"  form  appears.  Designate  the  name  of 
the  folder  and  the  title  of  the  document  you  wish  for  the  VMS 
file  under  WPS.  For  example,  enter  "DOCMAN"  for  document  name. 
Use  up  arrow  to  position  to  folder  name  if  you  want  to  change 
this;  for  example,  enter  "IISS  DOCS."  WPS  will  tell  you  when 
the  file  is  successfully  copied  into  your  WPS-Plus  folder.  You 
may  then 


1.  Print  the  RETRIEVED  document  by  pressing  "P. "  The 
Printing  Document  Form  will  appear.  It  should  have 
the  following  information; 
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Document  Destination:  LPAO  (for  Air  Force  VAX) 

Printer  Type:  LPll 

Number  of  Copies:  1  (or  another  number) 

"Preparing  Document”  will  appear  at  the  bottom  of  the 
screen;  press  "Return"  again  and  "Formatting  Document" 
will  appear.  Wait  and  WPS  will  tell  you  when  the 
document  is  printed  and  return  you  to  the  Main  Menu. 

Or 

2.  View  the  document  in  WPS  by  pressing  ”E”  (for  Edit) 
plus  Return.  The  top  of  the  document  appears.  To  go 
forward  in  the  document,  you  may  use: 

o  The  down  arrow 

o  Advance  Paragraph  (0)  (5)  on  the  keypad 
o  Advance  Page  (0)  (PF2) 
o  Advance  Line  (0)  (2) 

Or 

o  Gold  Search  (keypad  "PFl”  plus  ","  on  the  key 
board)  -  if  you  know  of  a  specific  phrase  in  the 
document  that  you  want  to  locate.  Type  in  the 
exact  phrase  you  wish  to  find,  press  ENTER  on  the 
keypad.  Press  "Gold  (Gold  period)  to  continue 
search. 

To  go  backward  in  the  document: 

o  Press  Backup  (1)  on  the  keypad  and  the  correct 
distance  you  want  to  go,  that  is.  Paragraph  (5) , 
Line  (2),  or  Page  (PF2) . 

Press  GOLD  F  once  you  are  done  viewing  the  RETRIEVED 
document.  The  document  will  be  filed,  and  the  Main 
Menu  will  appear. 

Or 

3.  Send  to  VMS  for  reading  as  follows. 

To  send  back  to  VMS  so  that  you  have  an  ASCII  copy  of 
the  document,  enter  "DT"  at  the  Main  Menu  and  then 
"SV”  (Send  to  VMS)  at  the  next  menu.  Enter  the  name  of 
your  file  including  directory  heading) : 

Filename:  [RABB] DOCMAN.DOC 

It  will  tell  you  when  the  file  is  copied  successfully  into  your 
VMS  directory.  You  then  may  then  exit  WPS-Plus  by  entering  "EX". 

$  TYPE  DOCMAN.DOC  (To  see  without  editing) 
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Please  note  at  this  point  that  documents  that  were  stored  and 
retrieved  from  DM  which  had  ".DOC"  as  their  filename 
extension  could  have  been  typed  under  VMS  directly  without  going 
through  all  this  work  which  is  required  for  ",WPL"  files. 

Documents  should  be  deleted  from  WPS  when  you  are  finished 
reading  them  to  save  storage  space.  Use  the  following 
procedure . 

Enter  WPS-Plus  if  in  VMS.  Be  sure  the  document  you  wish  to 
delete  is  in  the  upper  right  hand  box.  If  not,  enter  SEL  and 
press  Return  to  get  the  Selecting  Current  Document  Form  and  fill 
it  in  with  folder  and  the  document  names.  Return  to  the  Main 
Menu. 

Press  "D"  (for  "Delete").  WPS  will  ask,  "Do  you  really  want  to 
delete  this  document?  (Y/N)?"  Type  "Y"  and  the  document  will  be 
placed  in  the  wastebasket.  Enter  "FC"  (for  "Filing  Cabinet") 
and  a  second  menu  will  appear.  Enter  "EW"  for  empty  wastebasket 
and  you  will  be  asked,  "Do  you  really  want  to  delete  all 
documents  in  the  WASTEBASKET  (Y/N)?"  Enter  "Y"  and  the 
wastebasket  will  be  emptied.  Press  keypad  "0"  to  return  to  the 
Main  Menu. 

EXAMPLE  #2:  DM  CHECKOUT/RETURN 


If  you  wish  to  edit  a  document  and  then  return  it  to  DM,  the 
file  must  first  be  checked  out  according  to  the  following 
procedure : 

$  DM  (enter  "DM"  at  the  prompt  in  VMS  to  start  Documentation 
Management  Facility) 

(Your  authority  to  be  in  DM  is  checked  at  this  point) 

DOCUMENTATION  MANAGEMENT 


1)  DIRECTORY  of  documents 

2)  RETRIEVE  a  document  for  viewing  only 

3)  CHECK  OUT  a  document  for  possible  editing 

4 )  RETURN  a  checked  out  document 

5)  Enter  a  NEW  DOCUMENT  for  the  first  time 

6)  View  a  list  of  what  you  have  CHECKED  OUT 

7)  See  WHO  HAS  particular  documents  CHECKED  OUT 

0)  EXIT  (a  <RETURN>  also  exits) 

?)  You  may  enter  a  '?'  at  any  time  for  HELP 

What  would  you  like  to  do  [0-7]  :  7 

CHECK  OUT  A  DOCUMENT 


If  you  are  unsure  of  the  document's  name  or  subsystem,  use  main 
menu  selection  1. 
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Enter  the  Subsystem  :  SYS  (We  wish  to  retrieve  a  document  about 

the  SYS) 

Enter  Document  Filename  including  extension. 

Enter  the  Document  Name  :  DOCMAN.WPL 
Document  was  Found. 

1  am  now  copying  the  file  into  the  sub-directory  you  are  now  in. 
ALL  DONE. 

Please  return  document  within  a  reasonable  amount  of  time. 

(Main  DM  menu  comes  up  again) 

(Exit  DM  here  by  pressing  0  or  Return) 

$  WPS  (Enter  "WPS"  to  bring  up  WPS-Plus) 

At  this  point,  the  menu  for  WPS-Plus  will  come  up.  To  bring 
your  file  into  your  word-processing  folder,  enter  DT,  Return, 
and  then  RV  (read  from  VMS) .  Enter  the  name  of  your  file 
(including  directory  heading): 

Filename:  [RABB] DOCMAN.WPL 

Give  your  document  a  file  name  under  WPS,  press  Return.  WPS 
will  tell  you  when  the  file  is  sucessfully  copied  into  your 
WPS-Plus  folder.  You  then  may  edit  your  file  by  hitting  "E”. 

Use  GOLD-F  (file  &  exit)  or  GOLD-K  (quit  without  filing)  to 
finish  editing.  When  finished,  send  the  final  copy  to  VMS  so 
that  it  can  be  refiled  under  DM.  To  do  this,  from  the  WPS  main 
menu,  enter  "SV”  (send  to  VMS) .  Enter  the  name  of  your  file 
(including  directory  heading): 

Filename:  [RABB] DOCMAN.WPL  (.WPL  keeps  file  in  WPS-Plus 

internal  format) 

Note:  In  using  the  "SV"  command  a  WPS-Plus  file  will  be  sent  if 
the  filename  extension  is  .WPL  and  an  ASCII  file  will  be 
sent  if  the  file  extension  is  .DOC,  as  in  Example  #1. 

WPS  will  tell  you  when  the  file  is  sucessfully  copied  into  your 
VMS  directory.  You  may  then  exit  WPS-Plus  by  entering  "EX". 

$  DIR  DOCMAN.*  (Check  whether  new  version  of  file  is 

there) 

Directory  IISS_CDC: [RABB] 

DOCMAN.WPL; 2  DOCMAN.WPL;! 

2  Files  Found. 

The  file  can  then  be  RETURNED  to  the  DM  by  entering  the 
Documentation  Management  Facility. 
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RETURN  A  CHECKED  OUT  DOCUMENT 


$  DM  (enter  "DM”  at  the  prompt  to  start  Documentation 
Management  Facility) 

DOCUMENTATION  MANAGEMENT 


1)  DIRECTORY  of  documents 

2)  RETRIEVE  a  document  for  viewing  only 

3)  CHECK  OUT  a  document  for  possible  editing 

4)  RETURN  a  checked  out  document 

5)  Enter  a  NEW  DOCUMENT  for  the  first  time 

6)  View  a  list  of  what  you  have  CHECKED  OUT 

7)  See  WHO  HAS  particular  documents  CHECKED  OUT 

0)  EXIT  (a  <RETURN>  also  exits) 

?)  You  may  enter  a  '?'  at  any  time  for  HELP 

What  would  you  like  to  do  [0-7]  :  4 

Enter  the  Subsystem  :  SYS  (We  wish  to  return  document  about  the 

SYS  subsystem) 

Enter  Document  Filename  including  extension. 

Enter  the  Document  Name  :  DOCMAN 

OK.  Document  was  found  sitting  in  your  directory. 

I  am  now  copying  the  file  from  the  sub-directory  you  are  now  in. 
Document  Returned.  Thank  you. 

(Menu  prints  up  again;  press  Return  to  exit) 

Please  note  that  the  copy  of  your  document  in  your  VMS  directory 
will  have  been  deleted,  but  the  copy  of  your  document  in  your 
WPS-Plus  folder  still  will  be  there.  At  some  point,  your 
WPS-Plus  document  should  be  deleted  and  your  "WASTEBASKET" 
cleaned  up.  Please  see  WPS-Plus  manuals  for  more  details  on 
document  deletion.  (See  Example  #1  for  sample  procedure.) 

To  enter  a  NEW  DOCUMENT  for  the  first  time,  follow  the  same 
procedure  for  transferring  a  document  from  WPS,  to  VMS,  and  then 
to  the  DM  as  you  did  for  RETURNING  a  document  except  use  DM  main 
menu  selection  5  and  answer  the  appropriate  questions.  Use 
selections  6  and  7  at  the  DM  Menu  for  additional  information 
about  where  CHECKED  OUT  documents  are  located. 
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